package com.smart.community.work.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.smart.community.work.entity.CleaningRecord;
import com.smart.community.work.vo.CleaningRecordVO;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 保洁记录Mapper接口
 * 
 * 严格按照《Java后端SpringBoot代码开发规范_重构版.md》Mapper规范实现：
 * - 继承BaseMapper：获得基础CRUD操作
 * - 方法命名：使用select/insert/update/delete前缀
 * - 参数注解：使用@Param注解标注参数
 * - 返回类型：使用具体的VO类型而不是Object
 * - 异常处理：由Service层处理异常
 * 
 * @author Wu.Liang
 * @since 2025-01-30
 * @version 1.0.0
 */
@Mapper
public interface CleaningRecordMapper extends BaseMapper<CleaningRecord> {

    /**
     * 根据任务ID查询保洁记录列表
     * 
     * @param taskId 任务ID
     * @return 保洁记录列表
     */
    List<CleaningRecordVO> selectByTaskId(@Param("taskId") Long taskId);

    /**
     * 根据任务ID查询最新的保洁记录
     * 
     * @param taskId 任务ID
     * @return 最新的保洁记录
     */
    CleaningRecordVO selectLatestByTaskId(@Param("taskId") Long taskId);

    /**
     * 根据用户ID查询保洁记录列表
     * 
     * @param userId 用户ID
     * @return 保洁记录列表
     */
    List<CleaningRecordVO> selectByUserId(@Param("userId") Long userId);

    /**
     * 根据检查人ID查询保洁记录列表
     * 
     * @param inspectorId 检查人ID
     * @return 保洁记录列表
     */
    List<CleaningRecordVO> selectByInspectorId(@Param("inspectorId") Long inspectorId);
}